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DIR 




DIR 


d: 


DIR 


f i lename 


DIR 


*.typ 


DIR 


f i lename 


DIR 


X????.* 



TYPE filename. typ 
TYPE d : filename. type 



_,_ .. (current drive 
Display file di rectory | designated drive 

typ Search for named file, current drive 

Display all files of named type, curr drv 
* Display all types of designated filename 
Display all filenames 5 characters 
long and start with letter x 

current drive 



.«„,, r • i (current uiive 

Display ASCII £Hej designated dri 



ve 



ERA filename. typ 

ERA *.* 

ERA *.typ Erase 

ERA d : fi lename. typ 

ERA filename.* 



named file, current drive 
lall files, curr drv, V2.x curr user 

all files (designated j tv P e 
'named file* 'drive 

all types of named file, curr drv 



REN nuname . typ=ol name . typ > REName 
REN d : nuname . typ=olname . typi 



file 



I 



current drive 
designated drive 



SAVE 


n 


SAVE 


n 


d: 




USER 


n 



filename. typ 
d : f i lename . typ 



SAVE as named 



n pages 



current drive 
designated drive 
(page=256 bytes) start % 100H 



filej; 



Switch to designated disk drive 

A-D VI. 4; A-P V2 . x 
Change user area {Version 2.x) 




nA 

B 

-B 

nC 

nD 

E 

nFs 

H 

I 

Is 

nK 

nL 

nMx 

nNs 



nP 


Rfn 

nSx"Zy 

nT ^ 
U 

V 
nW 

nX 
nZ 
n 
<CR> 

n :x 

:mx 
n : :mx 



Append n 1 ines 

■ 

Move pointer 



to buffer (n=0 - 

!beg inningi 
end I of 

forward n char 
Delete n characters forward 
End edit, close file, return to 
Find n-th occurrence of string 
end edit, move pointer to begin 
Insert text at pointer until ~Z 
Insert string at pointer 
Kill n lines starting at pointe 
move pointer n lines 
execute command string 'x* n ti 
global F-command- until end of 
abort ED, start over with origi 

list next n pages of 23 lines f 
Quit without changing input fil 

Read fn.LIB into buffer at curr 
Substitute string •y 1 for next 

occurrences of string *x' 
Type n 1 ines 

change lower case to upper case 
enable internal line number gen 
Write n lines to output file (s 

beginning of buffer) 

Write next n lines to file 'XSS 

Pause n/2 seconds (2MHz) 

in lines* 
^forward \ x line ( and 

'backward i 

move to n line number and perfo 
perform command 'x 1 from curren 
move to n line number and perfo 
through line number m 



use half of buffer) 

file 

acters 

CP/M 
•s' 
n ing of file 

typed 



mes 

file 

nal file 

n=0 -current page) 

e 

ent pointer 

n forward 



(next entry 
era t ion 
tart at 



$$$$?. LIP 



type one 1 ine 



rm 'x ' command 
t 1 ine to 1 ine m 
rm command 'x' 



note: "-" valid on all positioning and display commands 
for backward movement (e.g. -nC) 



PIP COMMANDS 



PIP 

*d:=s:fi 
*d : nunam 



PIP 
PIP 
PIP 
PIP 
PIP 
PIP 
PIP 
PIP 



lename . typ 

;e. *=s:ol 
d :=s : f ilename 
d:«s:*.* 

d : = s : f i lename .* 
d : = s:*. typ 

LST:=f ilename. typ 
PUN:=f ilename. typ 
CON : = f ilename . typ 
filename. typ=RDR: 



Initiate Peripheral Interchange Program 
Copy named file (from source drv 
name. typ Copy&change filename jto destinat drv 
le.typ Initiate PIP and copy named file 
from source drv jail files 

{all named files 
drv fall files named typ 

Slist device 
punch device 
console device 
data from reader device to 



from source 

to 
destination 



send named 
Copy 



*nuname 
*d rnunam 
*nuname . 
PIP LST: 
PIP LST: 



named file (current drive) 
typ=aname.typ,bname.type,cnametyp' 
e.type = s:aname.typ,s:bname.typ 
typ=aname . typfX] , bname . typ[ XI 
= a name. typ,bname . typ 
=s: name. typ, srname. typ 



iSCI I i copy&con 
[ca tena te 
m-ASCir) files 



no 
send files in sequence 
to list device 




[B] 

fDn] 

[E] 

[F] 

[CM 

[HI 

(II 

(LI 

[N] 

[N21 

[0] 

r pi 
[Pnl 

rostr 

[Sstr 

[Rl 
[Tn] 

ru] 

[V] 

[W] 
(XI 
(Z] 



- read data block until "S character 

- delete characters past column n 

- echo all copy operations to console 

- remove form feeds 

- get file from n user area - V?.x 

- check for proper hex format 

- same as H plus ignores ":PP" 

- change all upper case characters to lower case 

- add line numbers with leadinq zeros suppressed 

- same as N plus leading zeros f. tab 

- object file transfer ; ignores end-of-filo 



insert form feed every 



n 



l ne: 



st r i nq is found 



ing"Z) - Quit copying after 
ing*Z] - Start copying when 

- read SYS file (V?.x) 

- expand tab space to every n columns 

- change all lower case characters to 

- verify copied data 

- delete R/0 files at destination (V?.x) 

- copy non-ASCII files 

- zero parity bit on all characters in file 



upper case 



PIP KEYWORDS 



CON: 
EOF: 
INP: 
LST: 
NUL: 
OUT: 
PRN: 



PUN: 
RDR: 



CONsole device (defined in BIOS) 

send End-of-File (ASCII-"Z) to device 

INPut source (patched in PIP) 

LiST device (defined in BIOS) 

send 40 NULls to device 

OUTput destination (patched in PIP) 

same as LST:; tabs every 8th character, numbers 

lines 6 page ejects every *P lines with 

initial eject 
PUNch device 
ReaDeR device' 



defined in BIOS 



refer to IOBYTE section for additional physical devices 



ASM CONVENTIONS 



labels followed by colon 
symbol (eg. EQU) no colon 



1- 6 alphanumeric characters 
first must be alpha, ? or . 



Assembly Program Format (space separates fields) 
label: opcode operand (s) ;comment 

Operators (unsigned) 



a+b 

a-b 
+b 
-b 

a*b 

a/b 

a MOD 
NOT 
AND 
OR b 
XOR b 
SHL b 

SHR b 



a 

a 
a 



b 

b 



added to 
difference between a and b 
0+b (unary addition) 
0-b {unary subtraction) 
a multiplied by b 
a divided by b (integer) 
remainder after a/b 
complement all b-bits 

(AND 

bit-by-bit JOR 

(XOR 

\left 

t ight 



shift a 



of a and b 



b bits, end off, zero fill 



Hierarchy Of Operations 

highest: * / MOD SHL SHR 

- + 

NOT 

AND 

lowest: OR XOR 



Constants 
Numer ic (post radix) 

B=binary 

, 0=octal 

D=decimal (default) 

H=Hexidecimal 
ASCII - in quotes (e.g. 



AM 



Pseudo-ops 
ORG const 
END start 

EQU const 

SET const 

IF const 

ENDIF 

DS const 

DB by tef,byte 

DW word [, word 



Set program or data origin (default***) 
End program. Optional address where 

execution begins 
Define symbol value (may not be changed) 
Define symbol value(may be changed later) 
Assemble block conditionally until ENDIF 
Terminate conditional assemhly block 
Define storage space for later use 

,bytel Define bytes as numeric or ASCII 
constants 

,word] Define word(s) (two bytes) 



const=constant (true if bit-0=l otherwise false) 




D Data error (element cannot be placed in data area) 

E Expression error (ill-formed expression) 

L Label error 

N Not implemented 

Overflow (expression too complicated to compute) 

P Phase error (label has different values on each 

pass) 

R Register error (specified value not compatible 

with op code) 
U Undefined label (label does not exist) 

V Value error (operand improper) 



DDT 

DDT filename. typ 

ASM filename 
ASM d:filename 
ASM filename. abc 



LOAD filename 
LOAD D:filename 

DUMP filename. typ 
DUMP d : filename. typ 

MOVCPM n 
MOVCPM n * 
MOVCPM * * 



SYSGEN 



Initiate Dynamic Debugger Tool program 
Initiate DDT and load named file 



icur rent dr i ve 
'designated drive 



Assemble named ASM 

file on : 
a=source file drv; b = HEX file destin 
ation drv ( Z=skip) ;c=PRN file destin- 
ation drv (X=console, Z=skip) 
Make .COM file from (current drive 

file on: 'designated drive 



named HEX 



Display file in hex 



current drive 
designated drive 



/and execute nKbyte CP/M system 
Create (image of nKbyte CP/M system 
(image of maxKbyte CP/M for 

SYSGEN or SAVE 

Initiate SYStem GENerate program 



SUBMIT filename parameters Execute SUB 
XSUB 



file using optional 
parameter (s) 
Execute extended SUBmit program (V2.x) 



ED filename. typ 
ED d : f i lename . typ 



STAT 
STAT 
STAT 
STAT 
STAT 
STAT 
STAT 
STAT 
STAT 
STAT 
STAT 
STAT 
STAT 
STAT 
STAT 



d: 

DEV 

VAL 

DSK 

USR 

f i lename. 

f i lename . 

d : f i 1 enam 

d:=R/0 

f i lename . 

f i lename. 

f i 1 ename . 

f i 1 ename . 

gd :=pd : 



typ 
typ 
e.typ 



SS 



Execute EDitor program to create 

or edit named file 

Display STATus-R/W or R/0 icurrent drv 
and available disk space fnamed drive 
DEV ice assignments 
VALid device assignments 
'DiSK characteristics! 
icurrent USeR areas \ V2.x 
size of f i le J 

file characteristics tcurr drv 

(named drv 
designated drive to Read-only 



Display 



typ $R/0 

typ SR/W Change 

COM SSYS 

COM SDIR 



named file to 



I Read-only 
Read-Write 
System file 
Drctry file 



V2.x 



Change general device (CON: ,LST: r PUN: 
and/or RDR:) assignment of 
physical device (see IOBYTE) 



CP/M DISK FORMAT 



Media: 8" soft-sectored floppy-disk single density 

(IBM 3740 standard) 
Tracks: 77 (numbered thru 76) 

26 (numbered 1 thru 26) 
128 data bytes (one logical record) 
256,256 bytes (77*26*128) 
number of sectors from zero to 
capacity of disk. 
lKbytes-8 sectors (smallest file space allocated) 
6 sectors standard (space between consecutive 

1-7-13-19-25-5-11- 



Sectors/Track : 
Bytes/Sector :~ 
Storage/Disk : 
File Si ze : any 



Extent : 

Skew- 



physical sectors on track) 

17-23-3-9-15-2 1-2-8- 14 -20-26-6-1 2-18-24-4- 10- 16-22 



System: Track & 1 (optional) 

Track-0, sector 1: boot loader 
Track-0, sec tors 2-26: 
Track- 1 , sectors 1-17: 
Track-1, sectors 18-26: CBIOS 



CCP 6. BDOS 



Directory: Tr^ack 2: 16 sectors typ. 32-bytes/ent ry 

(64 entries typ.) - extents-0 and 1 



User File Area : Remaining sectors on 

Extents 2 and above 



Track-2 and -3 to 76 



charac 


C 


E 


H 


I 


J 


M 


P 


R 


S 


U 


X 


z 


delete 


rubout 



f unct ion 
Reboot CP/M {warm boot) 

Start new 1 ine 
Backspace and delete (V2.x) 
Tab 8 columns 
Line feed 
Carriage return 
Printer on/printer off 
Retype current line 
Stop display output - any 
character execpt "c restarts o 

Delete line 
same as "U (VI. A) 

backspace to start of line (V2. 
End of console input (ED & PIP) 
Delete and display 
l»st character (tape only) 



ASCII 


code 


wu 


05H 


08H 


09H 


0AH 


0DH 


10H 


12H 


13H 


utput 


15H 


18H 


x) 


1AH 


7FH 


7FH 



10 BYTE (0003H) 





Device 


LST: 


PUN. 


RDR: 


CON: 


Bit 


Posi t ion 


7 6 


5 4 


3 2 


2 1 


Dec 




Binary 















00 


TTY; 


: TTY: 


t TTY: 


TTY: 




1 




01 


CRT: 


PTP: 


PTR: 


CRT: 




2 




10 


LPTi 


l UPli 


! UR1: 


BAT: 




3 




11 


UL1: 


UP2: 


UR2: 


UC1: 





TTY: 
CRT: 
BAT: 
UC1 : 
LPT: 
UL1: 
PTR: 
UR1: 
UR2: 
PTP: 
UP1 : 
UP2: 



TeleTYpe 

Cathode Ray Tube type terminal 
BATch process (RDR= input , LST=output ) 
User defined Console 
Line Printer 

User defined List device 
Paper Tape Reader 
User defined 
Reader devices 
Paper Tape Punch 
User defined Punch 
devices 



FILE TYPES 



ASC ASCII text f 

ASM ASseMbly Ian 

BAK BAcKup copy 

BAS BASic source 

COM COMmand file 

DAT DATa file 

DOC Document fil 

FOR FORtran sour 

INT INTermediate 

HEX HEXadecimal 

LIB Library file 

PLI PL/I source 

PRN PRiNt file ( 

REL RELocatable 

SAV System file 

SUB SUBmit text 

SYM SID symbol f 

TEX TEXt formatt 

XRF Cross refere 

SSS Temporary fi 



ile, usually Basic source 

guage file (source for ASM program) 

file (created by editor) 
program file, usually tokenized 
(transient executable program) 



e 

ce p 

Bas 
form 

use 
file 
sour 
modu 
(V2. 
file 
ile 

er s 
nee 

le 



rog ram file 

ic program file (executable) 
at file (for LOAD program) 
d by macro assembler 

ce and object produced by ASM) 
le 

x) 
executed by SUBMIT program 

ource file 
file 



Filename - 8 characters maximum 
Filetype - 3 characters maximum 

Invalid filename and filetype characters: 

<>.,;: = ? f 1 



A sad 



Assemble symbolic code ; start at sad 



D 

D sad 

D sad,ead 



Dump RAM (cad; lfi lines 

to console (sad; 16 lines 



f rom : 



1 



sad thru ead 



F sad f ead , const Fill RAM from sad thru ead with constant 



G 

G sad 

G sad, bpl 

G sad,bpl,bp2 

G,bpl,bp2 

H a,b 

I filename 

1 f i lename . typ 

L 

L sad 

L sad, ead 



Start 
program 
execut ion 
at; 



saved PC 
,sad 

sad and stop at bpl 
'sad and stop at bpl or bp? 
cad and stop at bpl or bp2 



Display hex a+b and a-b 
Set up FCB iuser code 



(5CHJ f 



or : (R-co 



mmand (HEX or COM file) 



Dissasemble (cad; 12 lines 
RAM jsad; 12 lines 

from: (sad thru ead 



M sad,ead,nad Move RAM block from sad thru ead to nad 



R offset 



Read file specified by I command to RAM at 
normal address + optional offset 

S sad Substitute into RAM starting at sad 

T n Execute n instructions (default=l) with 

register dump (trace) 
U n Execute n instructions (default=l) with 

register dump after last instruction 
Xr Examine/change registers or flans 

X Examine registers (flag reg :C=car ry , Z=zero, 

M=sign, E=parity r I=aux carry) 

cad=current address sad=start address 

nad=>new address ead = end address 

?=error, can mean: file cannot be opened , checksum error 
in HEX file or Assembl er/Di ssasembl er overlayed. 



LOGIN BYTE (0004H) 



low nibble *= current drive (0 = A, 1=P ,etc. 
high nibble = current user (V2.x only) 




Byte (s) 

fl 

1-8 

9-11 

12 

13 

14 

15 

1*-31 
32 
32-35 



f unct ion 
dr Drive code 

fl-fp File Name 



= currmt, 1 = A, 2-B, etc 



t]-3 File Type fcl-1-R/Q; t2«l-SYS 
ex current FXtent number 

si reserved j vi 

s2 = f» on BDOS coll to 

Open, Make, search 
re extent Record Count 

d0-dn risk map 
cr current record for r/w 

rn random record number 



not used 
always flOH 



1 2 3 A 


5 


fi 


7 


P. 9 I? 11 12 13 1< 15 


K3rlfil£5!f3lf4 


f i 


1 i ■ 1 


t f\ 


f8 tllt2lt3lexlslls2lrcl 



16 17 IP 1? 20 21 ?2 23 ?4 25 26 27 ?p ? Q 3 fl 31 3 2 ? 334 35 
d61dlld2!d3Td"41d51cl^M7ldeM^ldlftMllfJl?ldl3Ml^fdl5Tcrlrfllrllr71 



{b«mensize-20K V2 . x ; memsize-lfiK VI . 4 ) 



System 
Scratch 

Area 
(0-FFH) 



Trans ient 
Program 
Area 

CCP 
area 



Hex Memory 
Locat ions 
^2 
3 
4 

5-7 
8-37 
38-3A 
3B-3F 
40-4F 
50-5B 
5C-7C 
7D-7F 
spe-FF 



Contents 




BIOS warm start entry point 

and current user 



jump to 

IOBYTE 

login drive number 

jump to BDOS 

reserved: interrupt 

RST7-used by DDT or 

reserved for 

scratch area 

not used 

File Control Block (FCB) area (default) 

Random record posi t ion-V2 .x (default) 

DMA buffer area (128 bytes) for input 

and output (default) 



vectors & future 
SID programs 

interrupt vector 

used by CBIOS 



33FF+b 
28FF+b 



COM file area 



V2.x 
VI. 4 



'34P0+b-3BFF+b» Console Command tV2.x 
2900+b-30FF+bi Processor 'VI ,4 



BDOS 
area 

BIOS 
area 



3C00+b-49FF+b> Disk Operating iV?.x 
3l00+b-3DFF+b> System 'VI. 4 

f4A0O+b-4FFF+bj I/O system JV2.X 
l^3E00+b-3FFF+bi 'VI. 4 




Hex 
add r 



Vector 
Name 



Funct ion 



Value 
passed 



Value 
Ret urned 



**00 

**03 

**06 

**09 

**0C 

**0F 

**12 

**15 

**18 

**1B 

**1E 

**21 

**24 

**27 

**2A 

**2D* 

**30* 



BOOT 

WBOOT 

CONST 

CON IN 

CONOUT 

LIST 

PUNCH 

READER 

HOME 

SELDSK 

SETTRK 

SETSEC 

SETDMA 

READ 

WRITE 

LISTST 

SECTRAN 



cold 

warm> start entry point 
check for console ready 
read from console 

(consol e 
write tojlist device 

(punch device! 
read from reader device 
move head to track-0 
select drive 

! track number 
sector number 
DMA address 
read i 
write* selected sector 

get 1 ist status 
sector translate 
subrout ine 



C=chara 



C=r 

C=drv no 
A s const 
A=chara 



C a drv no 
C-trk no 
C=sec no 
RC=DM£ 



A=chara 



HL=dph* 



A=dskst 



A-lstst 
RC=1 sec no HL=pysec 
DF=smap 



const=console status 

00=idle 

FF=data avail 
dph=disk parameter/ 

header address 
dskst=disk status 

00=OK 

01=error 
lstst-list status 

00=busy 

FF=ready 



lsecno^log ical sector number 



py sec* physical sector 
smap= sector interlace 

add ress 
chara=character 
drv no=drive number 
trk no=track number 
sec no=sector number 
DMA=DMA address 
* not used in VI . 4 
**= contents of location 



number 
map 



2 H 



^ (request to BDOS to perform specified functions) 



Function 
Number 

in C reg 
Dec Hex 



Perip- 
heral 
I/O 



Disk 
I/O 



V2.x 
only 



V2.2 & 

later 

not 
used 




1 
2 
3 

4 

5 



7 
8 
9 

If 



13 

14 

15 

1* 
17 
18 
19 
20 
71 
22 



function 



00 
01 
02 
03 

04 
05 

06 

07 
08 
09 
0A 



Value 

Lassed to BDOS 
in DEfor E)regs 



11 CB 



1? PC 



0D 

0E 
OF 

10 

11 

12 

13 

14 

15 

16 



23 17 

24 18 

25 19 

26 1A 
,27 IB 

28 1C 

29 1C 

3P IE 

31 IF 

32 20 

33 21 
"M 22 

35 23 

36 24 
37 25 
40 28 

8 2f 

9 27 



system reset 
console read 
console write 
reader read 

unch write 
1st write 



?1 



di 



m 



get I 
set I 
pr int 
read 

buf 
get c 

sta 
lift 
get v 
reset 

sel ec 

open 

close 

searc 

searc 

delet 

read 

wr i te 

creat 



OBYT 
OBYT 

str 
cons 
fer 
onso 
tus 
head 
ers 

dis 

t di 
file 

fil 
h fo 
h fo 
e fi 
next 

nex 
e f i 



on 10 



E=char 



E=char 



E 

E 
ing 

ole 

le 

(VI. 
(V2. 
k ** 

sk 

e • 
r f i 
r ne 
le 

rec 
t re 
le 



x 



le 
xt 

rd 
cd 






rename file 

get login vec 
get disk no. 
set DMA addr. 
get al loc vec 
write protect 
get R/O vecto 
set file attr 
get addr (dis 

pa rame ters) 
set/get user 

code 
read random 
write random 
compute file 



tr 



tr 

r 
ib 

k 



E . ,FFH(input) 
cha r (output 



E=IOBYTE 
string addr 
addr of data 
buf fer 



s 
set 



ze 

random 



re 

reset drive 
write random 
wi th zero fil 



1 



* • 

• • • 



VI .4 
VI .4 



none 



E=drive no 



IFCB addr 



FCB addr 



old file 
FCB addr 
— (VI. 4) 

DMA addr 



FCB addr 



I 



B- FFH(get) 
user code (set 

FCB addr 
(r0,rl,r2 
format) 



drive vector 
FCB addr 



Value 
Returned in 
A (or HL) regs 



char 



cha r 



0=not ready 

char 

IOBYTE 



chars in 
buffer 

00(not ready) 
FF (ready) 

HL=version no 



[dir 
FF(not found) 



00(val id) 

dir 

FF(disk full) 

directory code 

FFfnot found) 

HL=drive code 

A=cdn 

HL=ava 

HL=R/0 vector 
dir 

HL=dpba 

current code 

I j * ** 

;error code 

irandom record 
field set 



return code 



intializes system 
error codes 



and 



selects A drive 
01-reading unwritten data 



Bi-reaaing unwrircen aata 
03-cannot close current extent 
04-seek to unwritten extent 
0^-directory overflow (write only) 

Jk— conk n» c t- nhwrfml .-.•-. A -' A ! r* U 



seek past physical end of disk 



char-character (ASCI I) 

addr-add ress 

dir -directory code 

cdn -current drive number 

dpba-disk parameter block 



(A-P,P-l,etc) 
add ress 








the advanced 
systems journal for the 
serious microcomputer 



user 



MICROSYSTEMS is not for beginners or game 
players. It's the only advanced journal written exclu- 
sively for serious, sophisticated programmers and 
operating systems users— single and multiple. 
MICROSYSTEMS will keep you up to date with the 
state of the art in CP/M, CP/M-86 and MP/M 
systems and compatible programs, MS-DOS, 
OASIS, UNIX, Xenix and other new generation sys- 
tems and designs. You'll also find system refine- 
ments, operating procedures and innovations, pro- 
gram conversions and certain high-level 
applications. In addition, MICROSYSTEMS provides 
an extensive software directory and software and 
hardware product reviews in each issue. 

If you're one of the select few who can take 
advantage of the information MICROSYSTEMS pro- 
vides, you owe it to yourself to subscribe. Just punch 

out the subscrip- 
tion term you prefer 
on the enclosed 
card and mail it in 
the postpaid enve- 
lope provided . 
You'll save up to 
33%! 



NOTE: 

If your profession in- 
volves computer 
usage, your subscrip- 
tion to MICROSYS- 
TEMS may be tax de- 
ductible. Check with 
your accountant. 
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